home *** CD-ROM | disk | FTP | other *** search
/ Amiga Packmags / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a intro].zip / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a intro].adf / prog / tmt.doc < prev    next >
Text File  |  1996-12-24  |  11KB  |  376 lines
  1.  
  2.  This utility was giving to us to join our competitions so therefor
  3.  for exclusive use on Newsflash and the UGA serie. Check out our
  4.  prices and join our competitions too....
  5.  
  6.  VECTOR will soon write a monthly article for us so wait and see..
  7.  
  8.  
  9.                       --------------------
  10.                       The Mirage Tool V1.1
  11.                            by VECTOR
  12.                       --------------------
  13.  
  14.  
  15.  
  16. This program is only useful to assembly programmers !
  17.  
  18. Message to all SEKA freaks: SEKA is shit, DEVPAC is it !
  19. DEVPAC 2.14 ofcourse (1.0 is shit)
  20. ---------------------------------------------------------------------------
  21.  
  22. THE STORY
  23.  
  24.  
  25. Some months ago MEL coded his first demo and asked me if I could make a 
  26. program that would generate sinus tables for him. (AFTER TC had made 26
  27. sin-tables for him !). So I did and after months of coding, to much 
  28. updates and killing many bugs, this is the result :a completely mouse-
  29. controlled sinus-generator which will generate ANY sinus table YOU want.
  30. The program was ment to be used in our group only, but i've seen some
  31. pour guys (LAMERS ?!?!) trying to make sin-tables with their pocket-
  32. calculator or their own basic-programs, so I decided to release this 
  33. useful tool.
  34.  
  35. Don't forget to copy 'mathieeedoubbas.library' in the LIBS: directory
  36. (sorry for that, but that's the way HiSoft handles Math)
  37.  
  38. ---------------------------------------------------------------------------
  39.  
  40. RUNNING IT
  41.  
  42.  
  43. When you start TMT you will see a status window, showing 'Initializing...'
  44. and after a few moments it shows 'Ready.' 
  45.  
  46. TMT has three menus on the menu bar. The first menu, named PROJECT, contains
  47. four boring options. 
  48.  
  49. PREFERENCES        - your prefs. (see below)
  50. MEMORY             - just the amount of memory left in the system.
  51. ABOUT              - some information about the program itself.
  52. QUIT               - leave the program.
  53.  
  54. The second menu contains the real thing...
  55.  
  56. SINUS              - Generate a standard sinus table
  57. ADD n SINUSES      - Add a number of sinuses
  58. MULTIPLY n SINUSES - Multiply a number of sinuses
  59. SINUS Dec/Inc      - Bounching effect
  60. TRIANGLE           - Generates a very blocky thing
  61.  
  62. And a new menu:
  63.  
  64. TXconvert          - Converts ASCII text into font positions
  65.  
  66. PREFERENCES:
  67.  
  68. When you select this menu, a window will pop up. This window contains two
  69. options:
  70. 1) 
  71.    Redefine the circle, the number in the box will be the amount of
  72.    steps a circle is devided in (default 360 degrees). So when you fill in
  73.    256, the circle will be devided in 256 steps (A guy from 'BOUNTY' wanted
  74.    this option, so is build it in)
  75. 2) 
  76.    The sign '- +' means that at the end the minimum value plus
  77.    the maximum value will be the maximum value (The value you filled in in
  78.    the input window !)
  79.    The sign '0 ±' means that the biggest value will be the maximum value.
  80.  
  81.    got it ?, No ?
  82.    Well,let me give you an example.
  83.    Lets say that you have selected '- +', go to 'SINUS Dec/Inc'
  84.    The value you fill in in the box 'maximum value' is very important !
  85.    After calculating the sinus, you go to 'Info' and you will see that
  86.    the minimum value plus the maximum value is exactly the number you
  87.    filled in in the box 'maximum value'.(Useful !?!?)
  88.    Lets go to the preferences again (Don't forget to click on Quit!)
  89.    Now select '0 ±', calculate the sinus again and go to 'Info'. Now
  90.    you will see, that the biggest value is recalculated to the
  91.    maximum value ! (Thought of this option myself)
  92.  
  93.    IF 'you got it' THEN 'read on' ELSE 'you are an empty head'
  94.  
  95. ---------------------------------------------------------------------------
  96.  
  97. HOW TO USE TMT
  98.  
  99.  
  100. When you select one of the items in the second menu, a window will pop up,
  101. with default values for a sinus table. Simply click in a box and you can
  102. alter the number.
  103.  
  104. SINUS/TRIANGLE:
  105.  
  106. 'Maximum value'    The maximum height of the sinus
  107. 'Length one wave'  The lenght of one sinus
  108. 'Amount of datas'  Amount of datas to create
  109.  
  110. SINUS Dec/Inc
  111.  
  112. 'Begin value'      The maximum value at the begin
  113. 'End value'        The maximum value at the end
  114.  
  115. ADD/MULTIPLY SINUSES:
  116.  
  117. 'Amount of sinuses'  Number of sinuses to add/multiply
  118. 'Amount of datas'    Amount of datas to create
  119. 'max. value'         Maximum value of sinus at the end
  120.  
  121. The rest of the input is the same as 'SINUS/TRIANGLE'
  122.  
  123.  
  124.     <-------------- Amount of datas ------------>
  125.                                                         *1   *2
  126.         x x x                           x x x          ---  ---
  127.       x       x                       x       x         |    |
  128.     x           x                   x           x       |    |
  129.   ----------------x---------------x----------------    ---   | 
  130.                     x           x                            |
  131.                       x       x                              |
  132.                         x x x                               ---
  133.  
  134.     <------ Length one wave ------>
  135.  
  136. VIN(Very important note) : 
  137. Max. value will be *1 when you have selected '0 ±' in the preferences or
  138. max. value will be *2 when you have selected '- +' in the preferences.
  139. (See 'PREFERENCES' for more detailed information)
  140.  
  141. NOTE: You can leave the line editor, either by pressing RETURN or an 
  142.       illegal key ! (such as ESC)
  143.  
  144.  
  145. After clicking 'CALCULATE WAVE' the program generates the sinus table for 
  146. you. The status window shows 'Working...'
  147. When finished the program will pop-up a graphic window showing the sinus 
  148. itself, a control window and an empty window.
  149.  
  150.  
  151. ---------------------------------------------------------------------------
  152.  
  153. THE CONTROL WINDOW
  154.  
  155.  
  156. The control window contains some tools to edit the sinus
  157.  
  158. Move:      The number is the amount of places to move. Clicking on either
  159.            '<' or '>' will decrease or increase the number of places to move.
  160.            Click on the box and you can fill in your own number ( <=99 )
  161.            Clicking on 'Right' or 'Left' will move the sinus (guess what ?)
  162.            to the right or to the left.
  163.  
  164. All  \     Will show you a preview of the sinus in the empty window.
  165. Even  |:   This can be either all lines, the even lines, or the odd
  166. Odd  /     lines.
  167.  
  168. Info:      Shows some info about the sinus 
  169.  
  170. Flip:      Flips the sinus (can be turned on/off!)
  171.  
  172. Modules:   All negative values will be positive (can be switched off)
  173.            (nice for bounching scrollers !)
  174.  
  175. Odd/Even:  See for yourself (don't know how to explain it)
  176.  
  177. Backwards: same as the backwards function of AUDIO-MASTER
  178.  
  179. Quit:      quit to the main menu
  180.  
  181. Save:      pops up the save window
  182.  
  183.  
  184. ---------------------------------------------------------------------------
  185.  
  186. THE SAVE WINDOW
  187.  
  188.  
  189. With this window you can tell the program how to save the sinus table.
  190.  
  191.  
  192. 'Convert list in'           Makes either DC.W or DC.B tables.
  193.  
  194. 'Convert wave in'           Converts the sin-values in words or bytes.
  195.  
  196. 'End list with'             Adds a mark to the end of the table.
  197.  
  198. 'End data with'             With this you can add something to the values.
  199.                             (such as '90F')
  200.  
  201. 'Offset before multiplying' Number to add to the values before mult.
  202.  
  203. 'Multiply wave with'        Number to multiply values with (very usefull for
  204.                             bitplanescrollers (you don't have to multiply in
  205.                             the program itself))
  206.  
  207. 'Offset after multiplying'  Number to add after multiplying.
  208.  
  209. 'lowest value to zero'      The lowest value will always be zero if this is
  210.                             'YES'.
  211.  
  212.  
  213. Click 'SAVE WAVE' if you want to save the table. Clicking 'CANCEL' will
  214. bring you back to the control window.
  215.  
  216.  
  217. THE EMPTY WINDOW:
  218.  
  219. Looks very empty doesn't it ?
  220.  
  221.  
  222. NOTE: Green means selected !
  223. ---------------------------------------------------------------------------
  224. The textconverter:
  225.  
  226.  
  227. WHY?
  228.  
  229. The textconverter was written to reduce the fontdata to a minimum.
  230. The textconverter converts ASCII text directly into fontpositions.
  231. The only thing you have to do is, get a byte, multiply it with your
  232. fontsize and add it to your fontbase. You now have a pointer to character.
  233. No messing around with modulos or such things. Another advantage :
  234. No more text ripping. All text is unreadable.
  235.  
  236. HOW?
  237.  
  238. Converting is nice, but what stands were ?
  239. Well here is the list :
  240.  
  241. Character:    ASCII-code:    Converted code:
  242. ----------    -----------    ---------------
  243. SPACE    $20    $00
  244. !    $21    $01
  245. "    $22    $02
  246. &    $26    $03
  247. '    $27    $04
  248. (    $28    $05
  249. )    $29    $06
  250. ,    $2C    $07
  251. -    $2D    $08
  252. .    $2E    $09
  253. :    $3A    $0A
  254. ?    $3F    $0B
  255. A    $41    $0C
  256. B    $42    $0D
  257. C    $43    $0E
  258. D    $44    $0F
  259. E    $45    $10
  260. F    $46    $11
  261. G    $47    $12
  262. H    $48    $13
  263. I    $49    $14
  264. J    $4A    $15
  265. K    $4B    $16
  266. L    $4C    $17
  267. M    $4D    $18
  268. N    $4E    $19
  269. O    $4F    $1A
  270. P    $50    $1B
  271. Q    $51    $1C
  272. R    $52    $1D
  273. S    $53    $1E
  274. T    $54    $1F
  275. U    $55    $20
  276. V    $56    $21
  277. W    $57    $22
  278. X    $58    $23
  279. Y    $59    $24
  280. Z    $5A    $25
  281. 0    $30    $26
  282. 1    $31    $27
  283. 2    $32    $28
  284. 3    $33    $29
  285. 4    $34    $2A
  286. 5    $35    $2B
  287. 6    $36    $2C
  288. 7    $37    $2D
  289. 8    $38    $2E
  290. 9    $39    $2F
  291. a    $61    $30
  292. b    $62    $31
  293. c    $63    $32
  294. d    $64    $33
  295. e    $65    $34
  296. f    $66    $35
  297. g    $67    $36
  298. h    $68    $37
  299. i    $69    $38
  300. j    $6A    $39
  301. k    $6B    $3A
  302. l    $6C    $3B
  303. m    $6D    $3C
  304. n    $6E    $3D
  305. o    $6F    $3E
  306. p    $70    $3F
  307. q    $71    $40
  308. r    $72    $41
  309. s    $73    $42
  310. t    $74    $43
  311. u    $75    $44
  312. v    $76    $45
  313. w    $77    $46
  314. x    $78    $47
  315. y    $79    $48
  316. z    $7A    $49
  317.  
  318. (All codes greater or equal than $a0 will be copied directly)
  319. So that was the list. The lower-case is handy for funny objects or so.
  320. If you want to include speed-codes or other codes in your text, then
  321. just type $ follow by a HEX code. This code will be directly converted
  322. into source.
  323.  
  324. Example :
  325. 'AAA $F5 AAA' would be converted to:
  326.  
  327. DC.B    $0C,$0C,$0C,$00,$F5,$00,$0C,$0C,$0C
  328.  
  329.  
  330. Your font-data MUST be saved in the order of the list.
  331. That means:
  332.  
  333. First 'SPACE' then '!' etc.
  334.  
  335. This tool together with the 'Font Chopper' will save you a lot of work.
  336. If you want to know how the 'Font Chopper' works then read the DOC of
  337. it. (Should be onn this disk too.)
  338.  
  339.  
  340. I hope that you'll find this option usefull.
  341.  
  342. ---------------------------------------------------------------------------
  343.  
  344. GENERAL INFORMATION
  345.  
  346.  
  347. Program name  : The Mirage Tool
  348. Version       : 1.1
  349. Last update   : 27 Dec 1989
  350. Language      : HiSoft BASIC
  351. Compiled with : HiSoft Compiler
  352. Crunched with : PowerPacker 2.3b
  353. Written by    : VECTOR of Mirage Holland
  354.  
  355. ---------------------------------------------------------------------------
  356. For bug-reports, new ideas for TMT, updates, etc.
  357.  
  358. Write to:
  359.  
  360.        P. de Boer
  361.        Zeeloodsenlaan 79
  362.        1785 BM  Den Helder
  363.        Holland
  364.  
  365.  
  366. This program may be freely copied, but you have to include the DOC file.
  367.  
  368.  
  369.                    SPREAD THE DISK AND THE WORD !
  370.  
  371.  
  372.                MIRAGE BEYOND THE LIMITS OF PERFECTION
  373.               ========================================
  374.  
  375.  
  376.